MyActivateProc
An activation function should have the following form:
pascal void MyActivateProc (DialogPtr theDialog, short itemNo, Boolean activating, Ptr myDataPtr);
theDialog
- A pointer to the dialog structure of the dialog box.
itemNo
- The number of the item selected.
activating
A Boolean value that specifies whether the field is being activated (true
) or deactivated (false
).myDataPtr
- A pointer to the optional data whose address is passed to
CustomGetFilePreview
.DESCRIPTION
Ordinarily, you need to supply an activation function only if your application builds a list from which the user can select entries. The Standard File Package supplies the activation routine for the file display list and for all TextEdit fields. You can also use the activation function to keep track of which field is receiving keyboard input, if your application needs that information.Your application is responsible for removing the highlighting when one of its fields becomes inactive and for adding the highlighting when one of its fields becomes active. The Standard File Package can handle the highlighting of all TextEdit fields, even those defined by your application.